¥ HOW TO USE MACCONTEST 4.¯

Ð Before starting the program be sure to set the internal clock to UTC using the
  Controlpanel.

Ð The files "MacContest.CTY", "MacContest.HLP", "MacContest.SETUP", "MacinTalk"
  and the PrinterDriver must reside in the systemfolder or in the same folder as
  the program / logs.

Ð After launching the program you must choose "NEW", "OPEN" or "IMPORT" from
  the "FILE" menu before you can go on. If you have choosen "NEW" you must name
  the document as in other programs, then choose the Contesttype if it is in
  the list included (otherwise push the "CANCEL" Button) and then fill out the
  dialogs.

  Push the "CANCEL" Button if you are starting for a VHF-Contest as there are no
  Contesttypes included in the list for these kinds of contest's.

  The settings will be saved to disk as a separate file and named like the
  logfile followed by " SetUp". Both files must reside in the same folder.


Ð NOTE: Not all Contesttypes included in the list have been tested on the air.
        It is up to you to check how they work and if the results are correct
        before you are going to use it in a contest.
        Pushing the "CANCEL" button when starting a new contest lets you use
        the whole program just without scoring.

Ð Set the band and mode using one of the buttons or use the "BAND"- and "MODE"-
  menus.

Ð Note that there is always only one enter-field in the main-window.
  In this field you can enter all items necessary for the contestlog (Callsign,
  Rcvd-report etc.). The program detects by itself which item you have entered.

Ð There will be a "?" in the enter-field as long as data is missing for a
  full Qso-record.

Ð Entering something that can't be a callsign or locator etc. won't be
  accepted and you are prompted with the note "Invalid input !".

Ð You can correct the input as many times as you want, just enter the new
  report or whatever has to be changed.

Ð Enter the callsign or received report or if needed the received locator.
  Then push the "ENTER"- or "RETURN-KEY" and the data will be set automatically
  to the appropriate item. The program shows you the country and CQ-/ITU-Zone
  after entering a callsign if this prefix is found in the "MacContest.CTY"
  list, otherwise it will tell you "Unknown Country".

  Worked callsigns from unknown countries are saved in a textfile named like
  the logfile followed by ".CTY". You may later include this prefix in the
  "MacContest.CTY" list with any text-editor before printing your Log.

  A "¥" in front of an entered callsign or received report indicates a new
  multiplier when finally the station is logged.

Ð If you enter a callsign from a station worked before, you are prompted
  with a note in the enter-field "Sorry Qso before !" and data for this
  contact is cleared.

  If you have checked the "Show Previous Qso" from the "OPTIONS" menu, the
  previous record will be shown in the window to the bottom.

Ð Your sent RS or RST is preset to "59" or "599" followed by the serialnumber,
  Zone etc. according to the settings in the SetUp. You don't have to enter the
  sent-report into the enter-field. This will be done automatically by the
  program. You can change your own RST eg. from "59" to "57" by entering a
  single "7", or from "599" to "339" by entering "339".

Ð Instead of entering always the "59" or "599" for the received-report you can
  use "CMD-KEY A" and then add the serialnumber (or whatever has to follow).
  Automatic CQ- or ITU-Zone is added with some Contesttypes, the Zone is
  activated in case you have to overwrite them before hitting the "ENTER"- or
  "RETURN-KEY".

- Note: Zones, Cantons etc. within the Rcvd-report MUST be separated
        with a "-" to be scored. Otherwise there will be no scoring of them.
        Do NOT include a "-" if it has not to be scored.

Ð Date and time will be updated every minute.

Ð When the items are filled out according to the settings in the "MacContest-
  SetUp" you are asked for the "Next one ?". Pushing now the "ENTER"-
  or "RETURN-KEY" will save the record definitely to disk and your new score is
  shown in the most right window.

Ð If you want to change something before saving the record to disk do it the way
  described above before pushing the "ENTER"- or "RETURN-KEY".
  If you want to clear the whole record because the contact could not be
  finished use "CMD-KEY BACKSPACE" to clear the window.

Ð You can use DA's while working with MacContest as in other programs, but
  only clicking the main-window will return you back to MacContest.
  Clicking one of the small windows, on the bottom, like the "Previous Qso"
  window will move them from the right side to the left side or vice-versa.

  Note: Reading a log with 3000 contacts or even more takes just a bit time,
        so if you will enter eg. a multi-multi operation with thousands
        of contacts you should use different files for each band.

        MacContest is NOT MultiFinder compatible, not now and not in the future,
        so there is no need to ask for.
        Using MacContest with System 7 is NOT recommended.


¥ FILE

- New
  Creates a new Log-File.

- Open
  Opens the selected Log-File.
  You may also open a log by double-clicking the log- or setup-icon within the
  finder.

- Close DA
  Closes an open Desk Accessory.

- BackUp...
  Let's you duplicate your Log-File, eg. to a separate disk, for safety reason.
  Having this Menu-point activated then each new entered qso will be added to
  the original file as well as to the backup file.

- Export ASCII File
  The current open File will be duplicated and saved as a Textfile. All items
  within a record are separated by a "tab", records itself are separated
  by a "carriage-return". You may use this option to transfer the Contestlog
  into another program. For example in a database or spreadsheet and print then
  your own designed logsheets or labels etc.

  Note: The File is duplicated the way it is in the memory. This means, if you
        just finished printing eg. sorted by callsigns, the Textfile is also
        written to disk sorted by callsigns.

- Import ASCII File
  This allows you to import a Log created with another program or re-import
  a previously exported Log. All items within a record must be separated
  by a "tab" and in the same order as they are when using the export command.
  Records have to be separated by a "carriage-return".

  Note: A simple error checking is done while importing and incorrect records
        are skipped.
        You can use "CMD-KEY ." to stop importing.
        Dupe checking is made while importing.

- Print Options...
  Brings up the "PrintOptions" dialogbox and lets you select from different
  prints and sorts:

  - Print Log
    Selects either a logsheet with 25 records on one page all separated
    by a blanc line, or 50 records on one page without blanc lines between.
  - Print Summary
    Prints a blanc Summary-sheet.
  - Print Label
    Selects a printout with all valid records on labels. For stations in
    countries listed in the "Exclude Countries"-field no printout will occur.

  - Endless Labels
    Used with the Imagewriters I, II and LQ.
    Select "No Gaps between Pages" in the Page Setup... before printing.

  - 24 Labels on A4
    Used (hopefully) with all other Printers.
    You might have to reduce the size somewhat, eg. to 90% on a HP-Inkjet, and
    adjust the Margins as well as the Gap between the Labels that they fit
    nicely on the paper.

  - Sorted by Numbers 001 ... 9999
    Selects the records to be printed in the order entered during the contest.
  - Sorted by Bands 1.8 ... 1200
    Selects the records to be printed band by band as entered during the contest
    on the single bands, starting with a new page when there are all contacts
    printed from the same band.
  - Sorted by Callsign A ... Z
    Is obvious. This might be of interest in combination with the Print Label
    command as you have the cards nearly sorted by countries.
  - Sorted by Locator
    Is obvious too.

  - Exclude Countries
    This option is used only in combination with Print Label.
    Enter the main-prefixes, each separated with a semicolon, from the countries
    you don't want to have labels printed.
    eg. with "HB,K,VE" in the "Exclude Countries"-field will not print labels
    from Switzerland, USA and Canada.
  - Label Footer
    Also used only in combination with Print Label.
    You have two lines for free text which will be printed on the label.
    To include your own locator from a VHF-Contest use one of the lines to
    include it on the label as the locator is not included in the report.

    The items in Exclude Countries and Label Footer are saved in the SetUp-File.

- Page Setup
  Used as in other programs.

- Print
  Prints the current open file according to the settings in Print Options.

  - Printing a complete log creates a textfile with the subtotals of all single
    pages, countries, prefixes, zones, cantons etc. worked on each band.
    The textfile is named like the logfile followed by ".PTS".
    You can later make a printout of this file with any text-editor.

- Preview Log
  Lets you check scoring of the log. (No WYSIWYG)

- Transfer...
  Lets you transfer to another program without returning to the finder.

- Quit
  Is also obvious.
  Left data in the buffer is saved to disk before returning to the Finder
  or launching the new program with the Transfer command.


¥ EDIT

- Undo, Cut, Copy, Paste, Clear are for use with DA's.

- Edit Log
  Lets you modify all items in a record except your own locator.
  Use the "Find"-, "Same"- and "GoTo" buttons as described in the "SEARCH" menu.
  After clicking in one of the editable items the program assumes that you
  made any changes and, if you have not used the "Save" button before moving
  to the next record, you are asked whether to save the changes or not.
  Every single modified record is saved to disk.

  Note: There is no Dupe checking made while modifying!
        If the data in the memory is not sorted by numbers,
        it will be reread first.

- Edit OptionKeys
  Lets you modify all OptionKeys used in MacContest if they do not match with
  your keyboard. Changes are saved in the MacContest program.
  The column on the left uses lowercase letters, and the column on the rigth
  is used with the caps lock down. To change any of the settings hold down
  the "OPTION-KEY" and push the appropriate key.

- Contesttype
  Let's you change the last choosen contesttype.
  The log will then be recalculated.

- Note Pad
  Let's you save a QSL-Info, Operator changes etc. to a separate textfile.

¥ SEARCH

- Find...
  Brings up a dialogbox and let's you enter a callsign to find in the
  currently open file. If a record with that callsign exists, it will be shown
  in the "Previous Qso" window. You may also enter only a part of a callsign.
  Use then the "Find Next" command to move through all records containing that
  part entered.

- Find Next
  Searches for the next record with the same callsign or callsignfragment.

- Record...
  Brings up a dialogbox and lets you enter one of your record-numbers.
  This record is then shown in the "Previous Qso" window.
  This Menu-item is only enabled if the active sort in the memory is by
  numbers.

- Print Label
  Prints one Label with the data from the contact found and shown in the
 "Previous Qso" window.
  Used only with Endless Labels!


¥ OPTIONS

- MacContest SetUp
  Brings up the "MacContest SetUp" dialogbox and let's you enter several
  informations used by the program.
  All information will be saved to disk in the SetUp-File.

  (If you put the included file named "MacContest.SetUp" into the SystemFolder
   or into the same folder as the program, you will not have to retype the same
   stuff again and again when starting a new contest. You may edit this file
   with any text-editor and adapt it to your personal needs.
   But be carefull when doing this.)

  The following entries might be entered or changed in this dialogbox:

  - Contest
    Enter the name of the contest.
    (This is allready done if a Contesttype was choosen at start-up.)

  - Callsign
    Enter the Callsign used during the contest.

    These two informations will be used for the header in the logsheet and for
    the summary sheet.

  - Category
    eg. single or multi-operator

  - Operators

  - Location

  - Rig

  - Altitude

  - Long East / Lat North
    Enter Longitude East and Latitude North of your Location.

    These informations will be used in the summary sheet.

  - RST AddOn
    Enter the Zone, State, Canton or whatever has to be combined with the
    report you send.
    eg. "-14", "-NY", "-BL"
    Leave this empty if no Zone etc. is used with your Sent-RST.

  - Locator
    Enter your own locator if your starting a VHF-Contest.
    Do NOT enter anything here if your heading for a HF-Contest. This item
    automatically changes some settings in the program which are used for a
    VHF-Contest only.

  - LogHeader
    Enter the needed column-titles for the logsheet.
    (This is already done for a VHF-Contest or if a Contesttype was choosen at
     start-up.)

  - Add SerialNumber
    Check this item if you need a serialnumber with the report you send. If this
    item is not checked, the serialnumber will be displayed to the right side of
    the enter-field in the main-window for your information on the number of
    contacts made. In this case it will be neither saved to disk nor printed.

  - Multimode
    Check this item only if the contestrules allow you to work the same
    station in different modes on the same band.

  - PostContest Entry
    Check this item to enter the contacts after the contest.
    With this item on and back in the main-window you are prompted to enter
    a starting date and starting time. They will then be shown in the main-
    window.

    Enter your contacts like described before. If you have now a dupe in your
    log the received report will be exchanged with "*** Dup ***", and if you
    are in a VHF-Contest the distance is set to 0, then you are asked to
    continue with the next one.
    Time and date will be no more automatically updated in this mode. Use the
    following keys to change date or time when needed for every contact entered:

    "CMD-KEY D"     moves the days one day up
    "CMD-KEY H"     moves the hours one hour up
    "CMD-KEY M"     moves the minutes one minute up
    "OPTION-KEY D"  brings up the "starting Date/Time" window
    "OPTION-KEY M"  moves the minutes one minute back

    Note: The hour moves automatically one up after 59 minutes.
          The month moves one up after 30 or 31 days corresponding to the
          month started, except in February where it moves after 29 days.
          The year moves one up after 31.12.xxxx.

- First Operator
  Brings up the "First Operator" dialogbox.

- Talk SetUp
  Brings up the "Talk SetUp" dialogbox.

  Using Talkmode with the 'MacInTalk' driver:

    Enter any text into the the textfields 1 - 6.
    eg. CQ, QRZ ?, QSL-info etc.
    Choose Pitch and Speed.

  Note: The 'MacInTalk' driver must reside in the log- or system-folder.
        (Does ev. not work with newer Systems!)

  Using Talkmode with digitized voice:

    To be able to use this feature you must use a systemversion which has the
    sound-icon in the Controlpanel included! A harddisk is recommended.

    Prepare named sounds like 'A'..'Z', '0'..'9', 'CQ', 'QRZ', '73',
    'WORKED B4', 'INVALID INPUT !', 'NEXT ONE' etc.
    using 'MacRecorder' or the 'SoundMaster' of a Macintosh 'LC' or 'SI'.
    Copy these sound resources into the 'snd '- resource of MacContest or your
    system using 'ResEdit', 'SoundMover' etc..

    Reserved names: 'WORKED B4'          used for dupes.
                    'INVALID INPUT !'    used in post-contest mode.
                    'NEXT ONE'           used in post-contest mode.

    Check the radio-button 'Digitized voice'.

    Enter any names of your sounds found in your controlpanel into the the
    textfields 1 - 6.

    You can combine several single sounds into one using a '+' between them:
    eg: 'CQ'+'CQ'+'MYCALL'+'MYCALL'+'GOAHEAD'

  If the "Talk" command is allready enabled you can test the sound by pushing
  the buttons numbered from 1 - 6.
  You'll get more information further down how you can use this item.

- Output to Printer
  With this item checked, every entered Qso will be sent to the printer.
  Make sure that the printer is ready and connected before checking this item.

- Output to Modem
  Switches "Output to Modem On/Off" and brings up the "Modem-SetUp" dialogbox
  when choosen the first time after having started with MacContest and opens
  the Modemport when pressing the "Ok"-button.
  You'll get more information on this point under the "TERMINAL" menu.

- Kenwood Interface
  Switches the Kenwood Interface (connected to the PRINTERPORT) On/Off.
  The active Band and Mode settings from the Transceiver are copied into the
  program while switched on. The use of one of the "Band"- or "Mode" buttons
  changes automatically the settings of the Transceiver and selects VFO A.
  You may set your transceiver on VFO B to any frequency by entering "QRGMHzKHz"
  into the enter-field and hitting "ENTER-KEY" or "RETURN-KEY":
  eg. "QRG14050" selects VFO B with the frequency 14.050 MC's.
  The contents of VFO A will not be changed so you can switch back to your old
  frequency by selecting VFO A on the frontpanel of your transceiver.
  I am using a 3 wire interconnect between the Mac and the TS-440 without using
  the optional interface supplied by Kenwood, only having inserted the necessary
  IC's in the TS-440 as described in the Instruction manual by Kenwood.
  This is cheap and works fine untill today.

  Macintosh 8-pin Mini-DIN / TS-440 6-pin DIN
  -------------------------------------------
  3 Transmit data    ---->    Receive data  3
  4 Ground           <--->    Ground        1
  5 Receive data     <----    Transmit data 2

  Note: "Output to Printer" will be disabled while this item is switched ON.

- Talk
  Switches "Talk Mode On/Off".
  While in SSB-Mode you have the possibility to send output to the loudspeaker,
  and from there to your transmitters mike.

  Entering the callsign as usually and pressing "ENTER-KEY" will output the
  callsign and report.
  Using "OPTION-KEY ENTER-KEY" will output your transmit-report only.


  Use the following keys to send automatic output to your modem:

  "OPTION-KEY 1..6" outputs entered text from the textfield 1..6

  While in "PostContest Entry" all entered text will be sent to the loudspeaker.

  Do not connect the audio-output directly to your transceiver as distortion
  will occur. A possible connection might be:

  Macintosh Loudspeaker  <-->  TS-440 Microphon with 2 x 20 dB Attenuation
  ------------------------------------------------------------------------
          R1       R1            R1       R1                     R1 = 47 ½
      <--/\/\--|--/\/\--]    [--/\/\--|--/\/\-->                 R2 = 10 ½
               /        ]    [        /              
  60 ½         \ R2     ] T1 [        \ R2      60 ½             T1 = 1:1
               /        ]    [        /
      <--------|--------]    [--------|-------->                 Ground
         
            
- Previous Qso
  Brings up a window which shows you the previous entered Qso during the
  contest or shows you the record your looking for within the "SEARCH" menu.

  If you hold down the "SHIFT-KEY" while choosing this menu-point again then
  it shows you allready worked Calls while entering the first letters of
  a callsign. This acts as a switch so you can select between the two kind of
  displays.

  You can paste the displayed callsign into the enter-field with "CMD-KEY V".

- Timetable
  Brings up a window with a small Worldmap displaying your location if Long/Lat
  is entered correctly in the SetUp, the Timezones, Grayline with the width of
  the Grayline and the times of a possible contact on the Grayline to the
  station entered into the callfield in the main-window. No display means that
  there is no match on the Grayline that day or time of the year or Long/Lat
  is missing in the 'MacContest.CTY' file for this specific country.

  The Grayline is updated every 4 Minutes.

  If you hold down the "SHIFT-KEY" while choosing this menu-point again then
  it shows you the distance and heading to the station entered into the
  callfield in the main-window instead of the Grayline information.
  This acts as a switch so you can select between the two kind of displays.

  Note: You must use a 'MacContest.CTY' file delivered with a 'MacContest'
        version not older than 3.9 to be able to use these features.
        Or you might add Long/Lat numbers yourself to your file as described
        in 'EDITING MACCONTEST.CTY'.

- Distance & ODX
  Brings up the "Distance & ODX" window if you are in a VHF-Contest and shows
  you the distance and Beamheading for the actually entered locator and your
  best DX. After saving the record the distance is added to the allover total.

- Qso by Band & Mode
  Brings up the "Qso by Band & Mode" window and shows you a list of all valid
  contacts made on each  Band, in each Mode etc. Contacts marked with
  "*** Dup ***" are not included! The list is only available during a HF-contest
  and will be updated after every entered contact.

- Worked Zones etc.
  Brings up the "Worked Zones etc." window and shows you a list of all Zones,
  Cantons etc. worked on the active band. You can move through all bands
  by changing the active band. The list is updated after every entered contact.

- Worked Countries etc.
  Brings up the "Worked Countries etc." window and shows you a list of all
  Countries, Prefixes worked on the active band. You can move through all bands
  by changing the active band. The list is updated after every entered contact.

- Help
  Might give you some help during a contest.
  (The file "MacContest.HLP" must reside in the systemfolder or in the same
   folder as the program / logs.)


¥ TERMINAL

- Modem SetUp
  Brings up the "Modem-SetUp" dialogbox.
  (The "KAM All Mode", "PK-232 All Mode" must be connected to the MODEMPORT).

  Enter any text up to 255 characters into the textfields 1 - 6.
  eg. RYRYRYRY, CQ, QRZ ?, QSL-info etc.

  Options:  "%C" inserts your partners callsign.
            "%R" inserts the received report.
            "%S" inserts your send report.
            "%L" inserts a linefeed.
            "%D" inserts the date.
            "%T" inserts the time.
            
            eg. "%C QSL UR %S BK" could send
                "HB9XYZ QSL UR 599001 BK"

  All the text is saved in the SetUp-File.

  Press the "Modem..."-button and select the Modem you have in use and then
  choose the appropriate baudrate for communication with your modem.

  Pressing the "Ok"-button returns you to the main-window and a small window
  under the main-window let's you monitor In- and Output from the modem.

- Terminal
  Switches Terminal Mode On/Off.

  You may also use "OPTION-KEY T" for this purpose.

  While in the Terminal-Mode, the program turns into a mini-terminal-program
  and you can enter commands, text etc. into the enter-field in the main-window.
  All entry is directly sent to the modem.

  Set up your modem for CW- or RTTY-Mode and switch off Terminal-Mode by using
  again "OPTION-KEY T".
  This also enables you eg. to say hello to your friends during an Rtty contest,
  and then switch back to normal Contest-Mode.

  Note: While in Terminal-Mode switching from receive to transmit or vice-versa
        is done with  the usual commands like "CTRL-C t" and "CTRL-C e" etc.

        If you hold down the "SHIFT-KEY" while choosing this menu-point again
        then you are in the "Terminal-BK" mode which means you do not have to
        send the "CTRL-C t" etc. commands as every single character is directly
        send to the transmitter.
        This acts as a switch so you can select between the two kind of modes.

  Use the following keys to send automatic output to your modem:

  "OPTION-KEY 1..6" outputs entered text from the textfield 1..6
  "OPTION-KEY 7..9" changes CW-speed to 20 wpm, 25 wpm or 30 wpm

  Using Output to Modem in CW mode:

    Entering the callsign as usually and pressing the "ENTER-KEY" will output
    the callsign followed by the report, eg. "HB9XYZ 599001 BL".

    Entering a callsign from a station worked before and pressing "ENTER-KEY"
    will output the callsign followed by "SRI QSO B4".

    Pressing "OPTION-KEY ENTER-KEY" will output your transmit-report,
    eg. "599001 BL".

    This output will be repeated as often as you use these key's.
    There will be no output by using the "RETURN-KEY".
    This allows you to change between computer output and your keyer without
    switching off the "Output to modem".
    The modem returns into receive mode after any output.

  Using Output to Modem in RTTY mode:

    Entering the callsign as usually and pressing "ENTER-KEY" will output the
    following text:
    eg. "HB9XYZ HB9XYZ DE HB9CEY HB9CEY"
        "599001-BL 599001-BL 599001-BL"
        "HB9XYZ DE HB9CEY BK"

    Entering a callsign from a station worked before and pressing "ENTER-KEY"
    will output the callsign followed by "...SRI QSO BEFORE...73...DE HB9CEY".

    Pressing "OPTION-KEY ENTER-KEY" will output your transmit-report,
    eg. "599001-BL 599001-BL 599001-BL"
        "BK".

    This output will be repeated as often as you use these key's.
    There will be no output by using the "RETURN-KEY".
    The modem returns into receive mode after any output.

    All output described above is DISABLED while in Packet-Cluster-mode.

    Clicking on the "Date" and or "Time" String in the main-window does
    include the actual Date and or Time into your transmit-report:
    eg. "599001-BL 599001-BL 599001-BL"
        "20:58 UTC"
        "HB9XYZ DE HB9CEY BK".

- Capture
  Switches Capture Mode On/Off and let's you capture data to disk.
  Each captured textline is numbered with the actually valid serialnumber,
  eg. "321 QSL via W1XYZ".

  You may also use "OPTION-KEY C".

  The textfile is named like the Log-File and ".CAP" is added,
  eg. "CQWW RTTY.CAP".
  You can later make a printout of this file with any text-editor.

- Send Text-File...
  Let's you choose a text-file to send to the modem.

  You may also use "OPTION-KEY S".

- Local Echo
  Switches Local Echo On/Off.

  You may also use "OPTION-KEY E".

- Large Window / Small Window
  Let's you change the size of the terminal-window.

- Packet-Cluster
  With any kind of TNC connected to the MODEMPORT you may use this feature
  as follows:

    Switch ON "Terminal-mode" and connect to a DX-Cluster, leave your TNC in
    convers-mode and switch OFF the "Terminal-mode".

    "CMD-KEY D" will paste the latest announced DX Spot into the enter-field
    in the main-window.
    If a Kenwood-Tranceiver is connected to the PRINTERPORT and "Kenwood-
    Interface" is switched ON, the Transceiver will be set to the frequency of
    that DX spot on VFO B. The contents of VFO A will remain unchanged, so you
    can switch back to your old frequency by selecting VFO A on the frontpanel
    of your transceiver.

    The same will be done by clicking on one of the max. 9 displayed lines in
    the terminal-window. That means you'll have the last 9 announcements
    memorized.

    "CMD-KEY S" will announce a DX to the Packet Cluster, taking the callsign
    from the call-field in the main-window. If this field is empty, the last
    saved call will be taken. The frequency is taken from the Transceiver if a
    Kenwood-Transceiver is connected to the PRINTERPORT and "Kenwood Interface"
    is switched ON.
    You will be prompted to confirm the frequency and call and you may add a
    comment before it is sent to the Packet-Cluster.


- Note: MacContest uses 'Software flow control', flow control characters are
        CTRL-S and CTRL-Q.


¥ SUMMARY OF SPECIAL-KEY'S IN MacContest

GENERAL
________________________________________________________________________________
CMD-KEY A             Inserts RST 59 or 599 according to the mode set
CMD-KEY Backspace     Clears the whole record entered before it is saved to disk
CMD-KEY V             Paste Callsign from "Previous-Qso" window into enter-field

POSTCONTEST-ENTRY
________________________________________________________________________________
CMD-KEY D             Moves the days one day up
CMD-KEY H             Moves the hours one hour up
CMD-KEY M             Moves the minutes one minute up

OPTION-KEY D          Shows the "Starting Date/Time" window
OPTION-KEY M          Moves the minutes one minute back

TALK MODE             (Only available in SSB-Mode or PostContest-Entry)
________________________________________________________________________________
ENTER-KEY             Transmits Callsign and report
OPTION-KEY ENTER-KEY  Transmits only report
OPTION-KEY 1..6       Transmits Text #1..#6

OUTPUT TO MODEM
________________________________________________________________________________
CMD-KEY M             Switches Output to Modem On/Off
ENTER-KEY             Transmits Callsign and report
OPTION-KEY ENTER-KEY  Transmits only report

OPTION-KEY C          Switches Capture Mode On/Off
OPTION-KEY E          Switches Local Echo On/Off
OPTION-KEY I          Inverts RTTY signal
OPTION-KEY S          Let's you playback a Text-File
CMD-KEY    .          Aborts playback of the Text-File
OPTION-KEY T          Switches Terminal Mode On/Off
OPTION-KEY X          Clears Data in Modem-buffer (KAM => CAnline $18 (CTRL-X))

OPTION-KEY 1..6       Transmits Text #1..#6
OPTION-KEY 7..9       Sets CW-Speed to 20 wpm..30 wpm

PACKET-CLUSTER MODE
________________________________________________________________________________
CMD-KEY    D          Paste latest DX Spot from Packet-Cluster
CMD-KEY    S          Announce latest worked DX to Packet-Cluster


¥ EDITING MACCONTEST.CTY

{Max. length = 25 chars}:  {2}: {2}: {2}:  {4}:   {Max. length = 60 chars}:
Sov. Mil Order of Malta:    EU:  15:  28:  1A0:   1A0:
Spratly Island:             AS:  26:  ..:  1S:    1S:
Monaco:                     EU:  14:  27:  3A:    3A:
Agalega & St. Brandon Is:   AF:  39:  53:  3B6:   3B6,3B7:
Mauritius:                  AF:  39:  53:  3B8:   3B8:
...
United Nations HB:          EU:  14:  28:  4U1i:  4U1I:
United Nations NY:          NA:  05:  08:  4U1u:  4U1U,4U43:
United Nations OE:          EU:  15:  28:  4U1v:  4U1V:       WAE Country
+ United Nations OE:        EU:  15:  28:  OE:    4U1V:       DXCC Country
Israel:                     AS:  20:  39:  4X:    4X,4Z:
Libya:                      AF:  34:  38:  5A:    5A:
Cyprus:                     AS:  20:  39:  5B:    5B,P36,H27:
...

Contents and description of the different columns for editing,
adding and deleting countries:

  #1 Country
     Max. length = 25 chars.

     Some countries are marked with a '+' sign to avoid a second list with
     WAE-countries.

     eg. United Nations OE:          EU:  15:  28:  4U1v:  4U1V:   WAE Country
         + United Nations OE:        EU:  15:  28:  OE:    4U1V:   DXCC Country
         If the contest requires the DXCC-list then '4U1V' is scored as 'OE'
         otherwise '4U1V' is scored as '4U1v'.
        
  #2 Continent
     Max. length = 2 chars.

     'EU', 'AF', 'AS', 'NA', 'SA', 'OC' are allowed.

  #3 CQ-Zone
     Max. length = 2 chars.

     eg. '15'

     Insert the zone most often worked or use '..' if more than one Zone is
     possible.
     CQ-zone is only used with contest-types requiring it in the rcvd-report.

  #4 ITU-Zone
     Max. length = 2 chars.

     eg. '28'

     Insert the zone most often worked or use '..' if more than one Zone is
     possible.
     ITU-zone is only used with contest-types requiring it in the rcvd-report.

  #5 Standard-Prefix
     Max. length = 4 chars.

     eg. '4U1u'

     This one will be used for scoring and printing the log.

  #6 Possible Prefixes
     Max. length = 60 chars {incl. all ',' as separators and ':' at the end}.

     eg. '4U1U,4U43'

     You can add or delete prefixes in this column, prefixes must be separated
     with a ',' as shown in this example.

     eg. '4U1ITU' is using the special Callsign '4U8ITU'
         Insert '4U8I' in the last column of that specific country
         and '4U8ITU' will be scored as '4U1i'.
         United Nations HB:          EU:  14:  28:  4U1i:  4U1I,4U8I:

     If you need more than the max. length of 60 chars simply insert a new line.

     eg. Asiatic Russia:             AS:  18:  ..:  UA9:   RZ0A,RZ0B,RZ0H...
         Asiatic Russia:             AS:  18:  ..:  UA9:   EX0A,EX0B,EX0H...
         Asiatic Russia:             AS:  19:  ..:  UA9:   UA0C,UA0D,UA0F...
         Asiatic Russia:             AS:  19:  ..:  UA9:   UV0C,UV0D,UV0F...

     Standard-Prefixes like 'KG4' etc. which could count for different
     countries, in this case 'Guantanamo' or 'USA', must contain the full
     callsigns in the column with possible prefixes otherwise it will be scored
     as 'USA'.

     eg. Guantanamo Bay:             NA:  08:  11:  KG4:   KG4AR,KG4DD,KG4DX:

     With 'VP2' it is sufficent to have the first letter after the number added.

     eg. Anguilla:                   NA:  08:  11:  VP2E:  VP2E:
         Montserrat:                 NA:  08:  11:  VP2M:  VP2M:
         B.V.I:                      NA:  08:  11:  VP2V:  VP2V:

     Possible Prefixes may not have the '/' sign included as MacContest
     filters out all '/' before it is searching the Countries-list.

     eg. after having entered the call 'HB9/W1ABC/M' or 'W1ABC/CT3' MacContest
         filters out 'HB9' or 'CT3' as the possible Prefix and then searches
         the list to find the standard prefix, cq-zone etc.

     Deleting a country is simply done by deleting the appropriate line
     in the list and adding a new country is nearly as simple as deleting one:

     eg: 'Fantasy Island' with the standard-prefix '5C' in cq-zone '39',
         itu-zone '53' will be a new one.
         All you have to do is to insert a new line in the list with
         all needed info:

         Cyprus:                     AS:  20:  39:  5B:    5B,P36,H27:
         Fantasy Island:             AF:  39:  53:  5C:    5C:
         Tanzania:                   AF:  37:  53:  5H:    5H:

  Note: Each column must be finished with a ':' and may not contain more
        characters as noted above.
        Possible prefixes must be written with uppercase letters and separated
        with a ','.
        Each line must be finished with a 'carriage-return'.

        Editing the list with a DA while you are working with MacContest
        does not edit the list actually used. In this case you must restart
        MacContest so the changed list can be read into memory again.

  #7 Longitude East/Latitude North
     Max. length = 15 chars and ':' at the end.

     eg. Fiji Island:                OC:  32:  56:  3D2:   3D2:  178.25/-18.08:

     Long/Lat is used for calculation of grayline-info or distance and heading.


¥ HACKER's SPECIAL or EDITING THE CONTEST VARIABLES

You don't have to be a programmer to edit the scoring variables but you should
be able to edit resources with REdit or ResEdit. Understanding the function of
these resources in MacContest let's you edit old contesttypes and even include
new ones in the future.

Variables used for contesttitle, logheader and scoring are held in 'STR#' -
resources 256, 257 and 258. They are all related to each other with their ID's.

'STR#' 256 holds the contestnames.                         string max. 54 chars
           eg. 'STR#' 256/9 holds the title of 'CQWW DX CONTEST'.

'STR#' 257 holds the scoring variables.
           eg. 'STR#' 257/9 holds the scoring var's for the 'CQWW DX CONTEST'.
               Description see further down.

'STR#' 258 holds the logheaders.
           eg. 'STR#' 258/9 holds the logheaders for the 'CQWW DX CONTEST'.
               Header #1 used for pts/qso                  string max. 11 chars
               Header #2 used for multiplier's (exception FieldDay)    25
               Column #1 used for pts/qso with own continent            4
                      #2 used for pts/qso with other continent's        4
                      #3 used for pts/country with own continent        4
                         also used for pts/qso with /P stations in FieldDay
                      #4 used for pts/country with other continent's    4
                      #5 used for pts/addon

Description of scoring variables held in 'STR#' 257:

char#  purpose                                             remarks

 1     points/qso with own continent on           1.8 MC   0..9 pts
 2                                                3.5 MC
 3                                                7   MC
 4                                               14   MC
 5                                               21   MC
 6                                               28   MC

 7     points/qso with other continent's on       1.8 MC   0..9 pts
 8                                                3.5 MC
 9                                                7   MC
10                                               14   MC
11                                               21   MC
12                                               28   MC

13     points/country with own continent on       1.8 MC   0..9 pts
14                                                3.5 MC
15                                                7   MC
16                                               14   MC
17                                               21   MC
18                                               28   MC

19     points/country with other continent's on   1.8 MC   0..9 pts
20                                                3.5 MC
21                                                7   MC
22                                               14   MC
23                                               21   MC
24                                               28   MC

25     points/addon                               1.8 MC   0..9 pts
26                                                3.5 MC
27                                                7   MC
28                                               14   MC
29                                               21   MC
30                                               28   MC

30..50 are mostly flags, default value '0' = false, '1' = true.

31     /P stations count different                        flag        (FieldDay)
32     pts/qso with /P                                    0..9 pts    (FieldDay)
33     qso with own country count's different             flag
34     pts/qso with own country                           0..9 pts
35     countries are not used at all for scoring          flag
36     prefixes are scored                                flag
37     addon count's only once through all bands          flag
38     cq-zone used                                       flag
39     itu-zone used                                      flag
40     qso with own addon count's different               flag    (eg. own zone)
41     pts/qso with own addon                             0..9 pts
42     addon's are not used at all for scoring            flag
43     country count's only once through all bands        flag
44     wae-list used                                      flag ('0' = dxcc-list)
45     pts/qso for certain countries are different        flag
46     pts/qso with these exceptions                      0..9 pts
47     pts/country for certain countries are different    flag
48     pts/country with these exceptions                  0..9 pts
49     pts/addon for certain addon's are different        flag
50     pts/addon with these exceptions                    0..9 pts
51     exceptions for pts/qso                             string max. 255 chars
52     exceptions for pts/country                         string max. 255 chars
53     exceptions for pts/addon                           string max. 255 chars
